package com.kosinsut.youtubeplaylistbuilder.songretriever;

import java.util.List;

import com.kosinsut.youtubeplaylistbuilder.Song;

/**
 * SongRetriever is the interface returning a list of songs. Users are almost required to implement it unless they want to use provided BillBoardSongRetriever.
 * @author Kosin
 *
 */
public interface SongRetriever {
	
	/**
	 * return a list of songs
	 * @return a list of songs
	 * @throws SongRetrieverException
	 */
	public List<Song> retrieveSongs() throws SongRetrieverException;

}
